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Appendix A 

Agent Descriptions 



ATG Dynamo 



Perl 



1.0 



High 



UAP 



10 minutes 



SNMP 



m 



^^^^^^^^^^^^^^^^^^^^^^^^^ 



mm 



tag 



llpi 



^^^^^^^^^^^^ 



d3 System 

• sysServerName 

• sysStatus 

• sysUpTime 

• sysTotalMem 

• sysFreeMem 

• sysNumlnfoMsgs 

• sysNumWarningMsgs 

• sysNumErrorMsgs 

d3LoadManagement 

• lmlsManager 

• ImManagerlndex 

• lmlsPrimaryManager 

• lmServicingCMs 

d3 S essionTracking 

• stCreatedSessionCnt 

• stValidSessionCnt 

• stRestoredSessionCnt 

• stDictionary S erverStatus 

d3DRPServer 

• drpTotalReqsServed 

• drpTotalReqTime 

• drpAvgReqTime 

• drpNewSessions 

d3DBConnPooling 

• dbPoolID 

• dbMinConn 
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• dbMaxConn 

• dbMaxFreeConn 

• dbBlocking 

• dbConnOut 

• dbFreeResources 

• dbTotalResources 




None known 




Collects various stats from the Dynamo server via SNMP. 
Configured through the "dynagentcfg" file. This script 
could easily be used to create other SNMP agent; the 
configuration file style makes it very versatility. 



CommerceTrends 





Perl 




1.0 




High 




TSN 


Tvpicallv Updated 


Dailv 


Collection Method 


Parsing text file output from CommerceTrends 




Daily Stats: 

• Page Views 

• SagFViews % of Month 

• -DWell Time 

• First-time Visits 

• Unique Visitors 

• Visit Minutes 

• Visits 

Monthly Stats: 

• Page Views 

• Visits 

• Unique Users 

• Users Visited Multi 

• Users Visited Once 

• Return Visits 

• First-time Visits 

• No-cookie Visits 








^^^^ 




Bugs 

Implementation 


None known 


CommerceTrends uses Perl scripts to generate all of its 
reports. 

/usr/local/commercetrends/wt_script/report.pl was 
modified to output statistics to a flat text file as the reports 
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were generated. The text files live at: 
vp3:/u05/commercetrends/xordata/incoming. 

CommerceTrends is configured to run the script 
/info/dashboard/bin/ct_j>ostprocess sitenumber when it 
finishes processing the logs. This script adds the 
information in the text file to a DBM file for the specified 
site. Another script, ct_agent ? is called to generate the 
XML file that's picked up by the reaper. 

Nearly any statistic that shows up in a report can be 
imported into VisionPort. It just takes some changes to 
each of the scripts mentioned above. 






1 8 Days Ago i ^^^^^H 


1,651,292 pv 

AsoFMay 22 2001, IZtOttem: fid 

337,673 visits 
2654^3 unique visitors 
44,008 new visitors 
5:03 dwell time 


^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

- 
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Foglight 





Perl 


Version 


1.0 




Hish 


Blstomers Using 


XOR 


{Typically Updated 


15 minutes 




Text Scraping 


liffiistics Returned 


Machine Load and CPU usage 


Bugs 


None known 


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 


Takes the Foglight site identifier in on the PATHINFO. 
For example: NT svstem(o),web-nt8. xor.com. 
Based on the type of system (determined from looking at 
the site identifier for "NT", "vision2" (bsdi), or "Sun", it 
executes a foglight command that outputs stats for that 
system for the past hour. 

Other statistics can be gathered. See the script for 
pointers to the foglight commands used to determine the 
statistics that are available. 



HTTP/Text Scraping Example 





Java 


Version 






1.0 


&*ii G ohiHf\ 
JVCltkaUIIit? 






High 


Customers Using 


None 


STypically Updated 


N/A 


Collection Method 


HTTP/Text scraping 




Stock ticker 


ilBugs • 


None known 




Ha 

IBilp 


Java version of the Perl-based quote fetcher for Yahoo 
stock ticker. 
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Informix DB Data Extraction 



Perl 



1.0 



Low; TSN-specific 



istomers Using 



TSN 



10 minutes 



;?^t: : .^i4'Si#;::;;::i:i i ; 



SQL Queries 



Registration information from the TSN user database 




None known 



treenshot 



TSN has lots of user data stored in an Informix database 
that lives on tsn-dbl. Scripts on tsn-db2 connect to the 
DB, extract relevant information with SQL queries, and 
format it into XML. 



■lilLif , , 







All: 304,688 users 

As of May 22 2001, 12:00am: <$ 1 h 

Fantasy BB: 24,810 
NFL Europe: 942 
Subs Charged: 807 
Subs Billed: 9,466 



PingTierl 







Perl 




piiiiiiiiii " : 


1.0 




XOR-specific 




MCC 




1 day 


Collection Method 


Text file scraping 








Average and Maximum ping time to XOR's tier-1 
providers over the past 31 days. 


B lies 




None known 


\ 


.tails 


Some shell scripts ping each of XOR's tier-1 provider 
connections every 5 minutes and store the results for 31 
days. The agent looks at the files and averages the 
maximum and average ping times. 



RealMedia OpenAdstream 





■ 




■ Perl 




Version 






Jill 1.0 




MSsability Level 


1 Low, unless another client uses OpenAdstream 
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.:CMtomers Using 


TSN 




10 minutes 




Log parsing 


sSl^fcBfti rned 


Number of ads served per ad position. 


■;^Bi|S ; s^^ : ' :: #t» 


None known 


!tt|plenientation 
Details 


Constantly reads the OAS log files on each machine and 
counts the number of as served. The agent reads a DBM 
file (the same one as the near-real time log parser. 




1 Today's Ads i ^^^^^^H 


Total: 2,402,605 

(171.34/s) 

As of May 23 2001, 9!07am: $ 10 m 

Top: 1,519,945 (108.1/s 
TopRight: 249,295 (13.9/s) 
BottomLft: 130,503 (9.3/s) 



Remedy 



Language 


Perl 


Version 


1.0 




High 


Customers Using 


XOR 




Hourly 




SQL Queries against Remedy database 


Statistics Returned 


Requests, Pending, Resolved, Min/Max/Avg TTR for 
each priority. Service Communications (email/phone). 
List of all incidents Started, Resolved, or Pending in a 
given time period. 




The Service Communications piece may not be accurate, 
as it's unclear how tickets that are opened automatically 
from HPOV are logged as "communicating". 




Connects via the following: 
'dsn' => 

f dbi:Oracle:host=evolve.xor.com;sid=ARSPRr, 
'username' => Visionjreport', 
'password' => Vision report' 



ServiceMetrics 



Language 




Perl 






1.0 


Reusability Level 


I 


High 




TSN 
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Hourly 



Incoming email parsed 



Page load time history for the past 24 hours 

Service Metrics' Internet Index and eCommerce Index 



llli 



Sometimes one data item has an additional field (data that 
it has collected so far this hour). If this data field exists, it 
should be deleted. 



l ails 



ServiceMetrics was configured to email a report to 
servicemetrics@xor.com . This email address pipes the 
output to a script that sends the data over to dev-linux for 
processing. On dev-linux, a script run from cron every 
few minutes looks for incoming files and delivers them to 
the correct programs for processing. 



- ' ,,:J: 

§11 



2.65 sec 



029 



il 



&-0 
5.2 
4-4 
3.6 
2.3 
2.6 



As of May 2B 2001, 6:00am: $ i h 



SQL Query Skeleton 




Language 




Java 



First-pass Java SQL query agent. It returns generic 
information, based on the SQL query specified to the 
agent. Arguments: 

• URL: string used to access the database 

• username: database username 

• password: database user password 

• labeledColumns: Boolean: whether or not to label 
columns in the XML output. 

• labeledNumeric: Boolean: if the labels should be 
numeric or strings; if strings, they're the SQL 
column names. 

• labeledZeroBased: Boolean: if the labels are 0- or 
1 -based. Even if labeledNumeric is false, this 
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variable is still used to determine how the returned 




"label" item's names are output as well as the 




returned rows' names. 




• query: SQL query to execute 



System Statistics 



%^3^Si=S Perl 



1.0 



Kill 



High, but only on same operating system. Currently 
implemented on BSDI and Linux. Easy to port to another 

as. 



TSN 



Typically Updated 



10 minutes 



Coll 



)d 



System Calls 



lgS 



1 ? 5, and 15 minute load time 

Uptime of the machine in seconds ("elapsed" data type) 
Approximate machine CPU utilization 




None known 



Uses a system call to "uptime" to gather 1, 5, and 15 
minute load times and the uptime of the machine. 
To gather information about CPU utilization, it uses: 

• BSDI: /usr/sbin/iostat -c 2 10 

• Linux: Looks at /proc/stat in 10 second intervals 



Avg Sptirri Wh6 



2.92 



0.12 



As of May 23 2001, 9:07am: $ 10 rn 

3 . 0r ^ 




Web Log Statistics (XOR): Near-realtime 





Perl 


Version 


1.0 




High on systems that use standard web logging. Would 
need to be modified to be used on NT. 




TSN 




10 minutes 




Parsing web logs on-the-fly 




For today since midnight: Hits, page views, visits, page 
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views per visit, page views per content area 


Bugs 


Hr|S=?EE:ll::lj;l:;:Ejj|::.-=_-. : 
f^;.::;..:;.,..:.:... - .tj 


None known 


Details 


illl'll 


A daemon runs on individual machines and parses the 
web log files on-the-fly. Every 10 minutes the daemon 
outputs the current statistics to a DBM file 
(/info/httpd/statsum^ The 
agent reads this DBM file to generate its XML. 










1 Today's Stats q 


496,601 pv (30.5/s) 

As of Hay 23 2001, 9i07am: $ 10 m 

4,384,060 hits (304.2/s) 
134,745 visits (9.0/s) 
10,530 reg visits 
54 new reg 









Web Log Statistics (XOR): Historical 



iguage 



Perl 



i 



1.0 




High 



TSN 




Daily 



ollection Method 




Extract statistics from DBM file generated from XOR log 
parser 



Hits, page views, visits, page views per visit, page views 
per content area for: 

• Yesterday 

• 8 days ago 

• 7 day average 

• 28 day average 
. : J|1I;1I| A 28 day running history is also available for "visitors". 



None known 

II A program on the log parsing machines (web-log and tsn- 
logs) analyzes log files nightly. When it's done with a 
day, it outputs stats for the day into a DBM file 
(/info/httpd/statsum/yyMM/^/^wame/misc). The agent 
| reads this DBM file to generate its XML. 



Web Log Statistics (XOR): Historical - Last Month Only 









Perl 










1.0 
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ilHii^Jilitv Level 


High 


hfcustomers Using 


MCC 




Daily 




Extracts statistics from past monthly reports by text 
scraping. 


iq^ii^eturned 


Hits, page views, visits, page views per visitor, megabytes 
transferred area for, this month, last month, and a year 
ago last month. 


iBugs 


None known 


iSPSliB ation 


Scrapes files on web-log.xor.com from 
/info/logs/old-logs/TTIT/Mow/www/.s'^ena/we. Is able to 
deal with web log reports that have been gzipped as well. 
The script gets the sitename from the PATH_INFO 
environment variable. It's called like: 

http://web-log.xor.com/cgi- 
bin/agents/weblog_stats_monthly_history/www.sitename. 

com 



WebPosition Gold 



: 1 


Perl 


Version 


1.0 


Reusability Level 


High * 


Customers Using 


None 




Weekly 


Collection Method 


HTTP calls, scraping the returned tab-delimited text 


flllBl ^^^^^^^^^^^^^^^^^ 

Bu£s 


irned 


Number of keywords searched for, total number of 
matches, average position, and for each search engine: 

• Number of matches 

• Positions for each match 

• Average position 


■■ 


None known 


Imjpleine'tttftti 


-■ ■. 

on 


WebPosition gathers information about how a site is 
ranked on search engines. It looks like the only way to 
get information out of it is through scraping text files that 
it generates. It only runs on NT. 

WebPosition is running on web-nt7. URLs to get the data 
is in the format: web- 

nt7.xor.com/reports/wvvw.sitename.com.txt 


^^^^^^^^^^^^^ 
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Search Engines 



Matches: 91 (34.21%) 

As of May 23 2001, 8:43am: $ 7 d 

In Top 10 : 46 (17.29%) 

Searches: 266 (19 sites) 

Avg Position: 12.7 

URLs Found: 44 



Yahoo News 





Perl 
1.0 




High, but this probably isn't legal 


Customers Using 


None 


IFvpically Updated 


Hourly 


ijfcollection Method 


HTTP calls, scraping the returned HTML 


Statistics Returned 

5111111 ![ ^^^^^^^^^^^^^^^^^^^^te^^^s 


Current news for a variety of topics (World, Tech, 
Finance, etc) 




None known 


gmplemeotation 
Details 


Calls URLs for different types of news. Examples: 
Headlines: http://dailynews.yahoo.com/headlines/ts/ 
Business: http://dailynews.yahooxom/headlines/bs/ 

It the scrapes the top news stories out of the HTML. 


^^^^^ ^^^^^^^^^^^^^ 



Yahoo Stocks 



Language 





Perl 








LI 

High, but this probably isn't legal 


Custoiyers Ustog ^ n — 


TSN 




10 minutes 




HTTP calls, scraping the returned HTML 


Statistics Return 


ed 


Today's history of the following indexes: NYSE, 

NASDAQ, DOW, and S&P 500. 

Can easily be customized to get stats for specific stocks 






115 

■pi! 


Bugs 




H8Ni 


The first quote of the day isn't recorded in the reaper 


=■'■''■ 


B 






repository. .This is likely a bug with the reaper when it 
receives a "clear history" instruction. 


Tmnlf 










Call this URL to get stock information: 

http://quote.yahoo.com/quotes?SYMBOLS= A DJI, A DaC, A 

SPX 

Note that other symbols can be added to the end to 
capture other quotes. 














III 






B 


^^^^ 




81 




'mm 
• 




HI 



Appendices 



Express Mail No. EL 841765098 US Page 1 1 



Cooley GOD WARD LLP 
Attorney Docket No.: XORI-002/00US 
Client No.: 240254 



Siteenshot 




11,158.14 , 9 T^ 0 

As of May 23 2001, 3: 07am i $ 10 m 

11369 ; 

li3 04 . . _ * 

11175*^^^ 

i 1 1 1 (t — - • -J 

11046 f - ~* 
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Agents Under Development 



HP Openview 





Perl 




High 




High 




MCC, dashboards for clients 




10 minutes 


'^^^^^^^'^^^^^ 


HPOV monitors machines/equipment from a networking 
level. This mostly determines if a machine or piece of 
networking hardware is available or not. 



Proposed Agents 



Keynote 





Perl 




High 


Customers 


Qwest 




Hourly 




Keynote is a site monitoring service, similar to 




ServiceMetrics. 



cPulse 



Desc 


ription 


XOR's clients use cPulse to deliver customer satisfaction 






surveys. 



MRTG 



Likelv Language 


Perl 


Priority 


Probably being scrapped in favor of OpenView stats 




High 


Customers 






10 minutes 


Collection Method 


Text file scraping 


Statistics Returned 


Current, average, 95 th percentile of bandwidth 




MRTG gathers live bandwidth statistics via the hosting 
infrastructure's switches. 
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Appendix B 

Dashboard Data Types 



dataitem 



.:#§ill|tioii 


The base class from which nearly all other data types inherit 
their default behavior. 




Abstract class 






1 name 


The name of this particular piece of information. The name 
can only contain the following characters: A-Za-z0-9_.- (no 
spaces or punctuation!) 




A description for this piece of information 




The data type of this particular piece of information 


tintestamp 


The time the current value was sampled 


XML 


None. The raw dataitem type should not be used directly. 



im age (Isa dataitem) 



Description 


A pointer to an image URL 




This has yet to be implemented in the controller 


Attributes m 




image 


The URL of an image to display 




<image name- 'statusjmage" 
image="http://visionport.xor.com/images/ok.gifV> 





tex t (Isa dataitem) 




Holds plain text. The plain text may contain newlines and 

leading spaces for formatting purposes. 

The formatting may be significant and should be respected by 
the GUI if possible. The Controller may reformat the text for 
display on a given device. 



The text to display 



<text name- 'first name">Tom</text> 



html (isa dataitem) 





tion 


Holds HTML markup text. 


Notes 

ma 399 




The Controller may need to reformat the text for display on a 
given device. The contents must be quoted so as to be valid 
XML. Alternatively, a CD ATA section could be used. 




■BBSS 




html 




The html to display 






- 


<html name= f, fancy_text l1 >this is 
<b>bold</b></html> 
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number (isa dataitem) 



g^ipiflci™** 


The base class for all data items that store numbers. It can 
hold either a single value or a value along with a set of 
historical values. 




Can hold any number (double/long/fraction/positive/negative). 
The datasets (if any) embedded into the number will always 
have names of 'values', 'rates', and 'timestamps'. 
The "value" attribute will always store the current value in the 
array of historical values. 






value 


The last sampled value of the item 


units 




What the number represents (dollars, percent, seconds, etc.) 




history 


Number of values to keep (0 is assumed if absent). This can 
also be configured in the reaper. 


i values 




Dataset of historical values; this is typically automatically 
created by the reaper 


tim 


*estamp$ 


Dataset of historical values; this is typically automatically 
created by the reaper 


rate 


fSS 


Rate of change based on the ratejype; the rate is typically 
created by the reaper 


rates 


Dataset of historical rates based on the rate type; the rates are 
typically created by the reaper; this is typically automatically 
created bv the reaper 


■ 




ratejype 


Tells the reaper the type of rate to generate. This is described 
in detail in the "Reaper" portion of this document, and is 
typically set in the reaper configuration file. 


XMT 
■E9B 




s 


Minimal: 

<number name- load avg' timestamp- 970169755' 
value= f 1.267> 

Everything: 

<number name-price' timestamp- ! 970 169746' value '1.49' 

units- $' history='4' rate- -.5' rate_type='average:r> 
<datasetname-Values'>1.49, 2.01, 1.67, 1.80, 1.57</dataset> 
<dataset name='rates'>-.5, .34, -.13, .33, .57</dataset> 
<dataset name= , timestamps , >970169750, 970169745, 

970169740, 970169735, 970169730</dataset> 

</number> 






■Hi: 


jjjJIj 


■ - : 




jp 

B 

pugg 


B 

1111 
111 

S 

HPS 
111 

■ 




* . 

SB! 

yllf 

ISIS 



counter fisa number) 





A number that is non-negative and monotonically increasing. 






Only increases until it is reset. 

If it ever decreases the reaper should throw an exception. 


■ ■■ 
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Same as number. 


XML 


<counter name- page_views' value='389222' 
timestamp='970169755'/> 



ga uge (Isa number) 





A non-negative number that indicates some value that can 
fluctuate up and down (for example, system load or number of 
active users). 




If the maximum or the minimum is not explicitly specified, 
then they are unbounded. 








Known maximum value possible; reaper should throw an 
exception if it increases over this limit. 




Known minimum value possible; reaper should throw an 
exception if it goes under this limit. 


XML 

^^^^^^^^^^^^^^^^^^^^ 


<gauge name-active users 1 timestamp- 970169755' 

value='17 r history='4 ? > 
<datasetname=Values f >17, 19,21, 16, 20</dataset> 
<dataset name='timestamps , >9701 69755, 970169745, 

970169735, 970169725, 970169715, </dataset> 

</gauge> 



elapsed (isa niimberj 



Description 


llilllls™ 


Elapsed time in seconds, used to express relative time (for 
example, uptime or visit length). 


Notes 




Is converted by the Controller into an appropriate format (for 
example, HH:MM:SS) 








N/A 


• 




■- - ■ 


■ 


<elapsed name- uptime 1 value- 3892 r 
timestamp='9701697557> 



chart (Isa dataitem) 



Descriptioi 


1 : 




A "chart" can store a set of axis/data labels plus multiple sets 
of values. Used instead of a number object when the axis is not 
time-based. 


Notes 




The number of items in the labels array, and in each values 
array must match the count attribute. 






• 




count , 


• 


The number of values on the x-axis and the number of values 
in each dataset 


labels 




Array of labels for the x-axis 


dataset(s) 


■ 


Dataset(s) of y-values 






<chart name- fuel__prices T count- 3'> 
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<labels>oil, gas, coal</labels> 






<datasetname-price'>35, 50, 15</dataset> 


I-:::-:: 




<dataset name= r tax'>20, 10, 12</dataset> 






</chart> 



labels (Isa dataitem) 





Holds a list of labels (used in chart) 






^Attributes 






Array of textual or numeric labels 




See chart. 



dataset (Isa dataitem) 



Beicription 


Stores a list of values (see chart and number for example use) 


Notes 




Attributes 




values 
XML 


Array of y-values 

<dataset name='price'>35, 50, 15</dataset> 



list (Isa dataitem) 



Description 


Holds a list of other items. 


Notes 


The name of each item in the list must be unique. 












lili 






<list name- status f > 

<text name- summary'>All servers are operational</text> 
<list name='wwwr> 

<number .../> 

<counter .../> 

<text name^ 5 status y > . . . </text> 
</list> 

<list name~www2 r > 

</list> 
</list> 


■- 


ill 


■MSB 


' 

-V 


mm 














• 





instruction (Isa dataitem) 





Communicates an instruction back to the reaper. 






Attributes 




name 


If the 'name' of an instruction data item is "noop", then the 
reaper will not record any information sent to it. Likewise, it 
will not update the item's history. This is useful for updating 
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data items that may not change frequently or have a period of 
inactivity (such as the stock market). 

If the 'name' of an instruction data item is "clear Jiistory", the 
reaper will clear this data item's history datasets before 
inserting the current data. This is useful for "resetting" 
histories. For example, the stock market history could be 
cleared every morning when the market opens, so that a new 
graph is started for the day. 






instruction name='noop7> 
instruction name=' clear historyV> 
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Appendix C 



NAME 

Dashboard 



DESCRIPTION 

Driver class for Dashboard XML project. 



SYNOPSIS 



Creating (aka. freezing) 

my $dashboard=new Dashboard ( ) ; 



Reading (aka. thawing) 

my $dashboard=new Dashboard (xml => $xml_string) ; 
my $dashboard=new Dashboard (file => $f ile_name) ; 



Accessing 

$item=$dashboard->select ( • path/to/item/within/ tree 1 ) ; 



PREREQUISITES 

XML::Parser 



CONSTRUCTORS 

The constructor can be called two ways: No arguments, which creates a brand-spankin' new data 
object, or with a chunk of XML or a file name, which will read and parse f * thaw") the XML, and 
construct a Dashboard data structure which can be queried, modified, and re-frozen as desired. 

Dashboard: : new (xml => 'some string of XML'); 

or 

Dashboard: :new(file => 1 some_f ilename_containing__XML ' ) ; 
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METHODS 



select( n selector/string/path n ) 

This will search the tree for an item that can be reached by the specified list of * ' selector" 
strings, which are separated by " 7" characters. 

At each level in the tree, an item will be searched for that matches the given selector. For Lists, 
the Dataitem with the specified name will be returned. For other item types, an attribute of the 
given name will be searched for. This attribute may be a scalar value, or it might be an Array or a 
pointer to another Dataitem type. 
Examples: 

Given the following XML: 

<dashboard> 

<list name=" alpha "> 

<gauge name='bravo' timestamp= ' 970594169 ' value= f 111 ' /> 
<list name = 1 charlie 1 > 

<counter name =' delta' historyLength= 1 3 1 timestamp= 1 970594170 1 
value= ' 2 0 ' > 
<dataset name= 'values 1 >2 0 , 30, 40</dataset> 
<dataset name= ' timestamps * >970594163 , 970594164 , 
970594165</dataset> 

</counter> 

<elapsed name^'echo' value='2932' timestamp= 1 970594168 ' /> 
</list> 
</list> 

<number name= ' foxtrot ' timestamp= ' 970594179 1 value= » 333 ' /> 
</dashboard> 

The following selectors will return the indicated objects (or die with an error as indicated): 

alpha 
bogus 

alpha/bravo 
alpha /bravo/ value 



alpha/bravo/value/bogus/ stuff 
alpha/bravo/bogus/ stuff 
a lpha/br avo / t ime s t amp 
alpha/char lie 
alpha/charlie/delta 
alpha/charlie/delta/value 
alpha/charlie/delta/historyLength 
alpha/charlie/delta/values 
alpha/charlie/delta/values/values 
alpha/charlie/delta/values/values/O 
alpha/charlie/delta/values/values/3 
alpha/charlie/ delta/timestamps 
alpha/charlie/del ta/ times tamps/values/ 1 
alpha/ charlie/ echo/value 
foxtrot 
foxtrot /value 
Strange cases: 

• To get the text of a text item use the selector 



List named "alpha" 
die: 1 bogus' not found 
Gauge named "bravo" 
Scalar : 111 
die: leaf at 'bogus' 
die: 'bogus' not found 
Scalar:970594170 
List named "charlie" 
Counter named "delta" 
Scalar : 20 
Scalar : 3 

Dataset named "values" 
ARRAY [20,30,40] 
Scalar :20 

die : index ' 3 ' not found 
Dataset named "timestamps" 
Scalar : 970594164 
:2932 



Scalar : 
Number 
Scalar: 



named 
333 



'foxtrot " 



./itemname/text" 



To get the body of an html item use * x .../itemname/html" 
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• To get the URL of an image item use x * .../itemname/image" 

• Charts: 

• To get the labels for a chart as an array use * x .../chartname/labels/labeis". 

• To get a dataset for a chart as an array use * * .../chartname/datasets/O/values". 

• To get the name of a chart dataset use * x .../chartname/datasets/O/values". 

• To find out how many datasets there are use * x .../chartname/datasets/count". 



select_scalar( ?f selector/string/path ft ) 

just like select ( ) , except that it errors out if the item returned is not a scalar value. 



xml_freeze() 

Returns an XML string representation of the data structure. 



xml_thaw($xml_string) 

Returns a new Dashboard object created by parsing the specified XML stored in a string. 
Preferred: use the "xml* argument on the constructor. 



add(LIST) 

Adds a list of Dataitems to the current Dashboard object. Will die if an attempt to add an item 
named identially to an existing item in the Dashboard is made. 

$dash=new Dashboard () ; 

$count=new Dashboard: : Counter (value=>5) ; 
$dash->add ($count) ; 
or even: 

$dash->add(new Dashboard: rCounter (value=>5) ) ; 
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Appendix D 

Controller Configuration Files 



Na vorg 



Desci 


iption 




The navorg element defines the initial structure and contains 
attributes for defining the renderer and the name of the data 
configuration file to use. 






Mates 




Attributes 




name 


Informational name of this display configuration. 




The path to the data configuration file. Optional, defaults to 
conf/data.xml. 


layout 


The name of the renderer that this user will use by default. The 
existing renderers arc framed and htmltable. Defaults to 
framed. 


iiiii^iliiiiii^i^ 

"!: : ' 


iplutcdir 


Template-override directory to use for this file. Can be 
overridden by templatedir specified in a section. Defaults to 
the username. 


XML 

■■■■■■NNI 




<navorg 

name-'The Sporting News" 

aliases~ r tsn_data.xmr 

layout="framed"> 

</navorg> 


VMM 


^^^^^^^^ 
^^^^^ 


ifiil! 

: : 

IP 







Section 



m 




H 


y 


The section element defines the layout of a single display 
page. Each display page can have multiple cells (also called 
constructs or indicators) on it. Sections are linked together via 
the onSelect attributes of constructs (see below). 






HI 

lip™ 








Note; 










■ 




name 




The name of the section. The section name must be unique 
across all sections. Required, "start" is the name of the first 
page the user will view. 


■ 




template 




Defines the template directory to use for overriding the default 
template directory. Defaults to the username. 








nplatet 




i 


Template-override directory to use for this file. Defaults to the 
templatedir specified in the navorg. 
























The number of cells per column to create. 










The number of cells per rows to create. 










The height of each row in the display. Defaults to 150. 


* * 

: ; „ colsiz 






The width of each column in the display. Defaults to 200. 
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The description of the section. This is not available to the 
templates and is mainly for documentation purposes. 




The help text for the section. If not specified, the cell will not 
contain a help link. 




<section name- ' start" description- 'Main Page" 
template="tsn M > 

<attr name- 'rows">4</attr> 

<attr name- 'cols">4</attr> 

</section> 

<section name="DJIA_chart" description- 'DJIA Chart"> 
</section> 



Construct 



Description 




The construct element (also called a cell or an indicator) 
defines a business intelligence object. The construct itself 
defines a container type, a template file, the refresh rate, and 
the links for common navigation elements (drilldown, help, 
reports). The item elements enclosed by the construct define 
the mappings between values in the XML data files and 
variable names in the template file. 






111111 




^^^^^^^ 



Notes 




Attributes 




name 


The name of the construct. Must be unique across the 
enclosing section element. 


■ 




*** 


iiii 


The position of the cell in the matrix of cells, starting with 1 in 
the upper left corner, proceeding across the columns and then 
down to the next row. The position must be unique across the 
enclosing section. If the position is not unique, only the last 
construct with the given position will be displayed. 


■ 

flPf 

: 


illliijpi^ 
■B! 




desci 


lotion 




The description of the cell. This should be short, as it is 
typically displayed in the template as a title for the indicator. 


+ i ■ + 


The template name that this construct will use. 






The refresh rate in seconds of this cell. This is typically 
calculated automatically when the dashboard data elements are 
loaded, as they themselves have the refresh rate of the data. 
The refresh is used to determine how frequently the indicator 
should try to refresh itself. 




infill 

■Mi 

. 




■ 
- 

■ 

fifes 


dutu 

iPii 


§■■§1 
S1HB 


y 


The frequency in seconds with which underlying data changes. 
This data_refresh number is typically displayed to the user on 
an indicator. If not specified, refresh is used. A typical use for 
data refresh is for information that updates itself daily, but for 
which you want to check every hour to see if the information 
has changed. The data refresh is to set it to 86400 (the 
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number of seconds in a day), but the refresh is set to 3600 (the 
number of seconds in an hour). So, the user sees on the 
indicator that the data updates every 24 hours, but the actual 
indicator refreshes itself every hour, looking for potential new 
information. 


onSelect 




Defines the section name that the indicator's drilldown icon 
(magnifying glass) will be associated with. If not specified, the 
indicator will not have a drilldown icon. 




Defines if the drilldown will be displayed in a separate popup 
window ("popup"), replaces the full screen ("full"), or replaces 
the current frame ("frame"). Defaults to "popup". 




Specifies a precision to limit all number elements to. The 
default is to leave numbers as-is. A precision of "1" will make 
numbers look like "2.5". This is handy for limiting the 
precision of averaged aggregate items. 




<construct name- 'Control" description- 1 Control" 

type= M control" position="l"> 

</construct> 

<construct name- 'DJIAcurrent" description- ? DJIA" 
type- 'number" position- ? 2" onselect- 'DJIA graph" 
data_refresh-"10"> 
<attr name- f helptext"> 
<U><B>Dow Jones Industrial 
Average</B></U> 
<P> 

The large blue number is the current value of the DJIA. The 
arrow indicates the current direction of the market since the 
market last opened. The arrow will be green if the market is 
up for the day, and red if it's down. The small number under 
the arrow is the change since the market last opened. 
<P> 

The chart displays how the market has moved over the past 8 
hours of activate trading. 

Every morning when trading begins, the chart begins anew. 
<P> 

This indicator is updated every 10 minutes. 

</attr> 
</construct> 


^^^^^^^^ 


^^^^^^^^^^^^^^^ 


1 


■ 


Mi 

■ 

plpi 


■ . ■. • 


iii 

iii 


If™ 


liil 




H 


liil 


IP 

11 


j ■ ■"■ ■ 

jiilliiiM 
^^^^^^^^^^^ 

9B95 




m 

B 

Hi 



Item 





ascription 

^^^^^^^^ 

■ 


Item elements define the set of data to be made available for 
use in the display template. An item can only appear inside a 
set of construct tags. 


Nc 


rtes 
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The name of the item. The name will in most cases also 
defines the name of the variable available in the template. An 
item name must be unique across the enclosing construct. 



The alias name of the source object (from data.xml). 



An additional path into the source item's object tree. 
Depending on the template variable that's being populated, the 
select will be either a leaf node (such as /sitestats/hits/value) ? 
or a non-leaf (such as /sitestats/hits/history). If a non-leaf is 
required for the template, the controller will do the work of 
gathering the required information out of the node. 



Sets a format for the controller to use for this item. Valid 
formats are: 

• dollars (uses precision of 2 and pre-pends a "$") 

• elapsed (converts to DD days, HH:MM) 

The controller also automatically formats: 

• If the select contains "timestamp", it will change the 
format to MM/DD/YY HH:MM. This is primarily used 
for auto-populating the x-axis on graphs. 

• If the item looks like a number (contains only digits 
and periods), it will: make a default precision of 2 and 
"comma-ize" the number. For example, 2003.456 will 

be changed to 2,003.46. 



— 



precision 



MBS 



Sets the numeric precision for the item. 




Defines a type of the particular item, which affects what is 
done with the data. Valid types are: 

• graph 

• table 



var 
alert 



Each of these types is explained in detail below. 



Sets the unit string for the data item. The unit value is made 
available to the template in the unit variable. 



Defines a prefix that is typically displayed before the item. 
The prefix value is made available to the template in the prefix 
variable. 



The type of graph to display (only valid with a type of 
"graph"). Can be one of: 

• bars 

• pie 

• lines 

Defaults to "lines" if not specified. 



Sets the value of an item of type "var". 
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an 

illllll 



<construct name-'SysLoad" description- 'System Load" 
type- 'number" positional 4"> 
<item name="alert" type="alert ,f source="ALERTS" 
select="SysLoad7> 

<item name="graph" type="graph" source- 'systemload" 
select="loadl57> 

<item name- 'current" source-'systemload" 
select="loadl5/value"/> 

<item name- 'history" source- 'systemload" 
select="loadl5/values/values7> 

<item name-'direction" source- 'systemload" 
select="loadl5/rate7> 

<item name="timestamp" source- ! systemload" 
select- 'loadl 5/timestamp"/> 
</construct> 



Item Types 

var 




Defines a variable to set in the template. 



The name of the variable. 



The value to set this variable to. 



<construct name- 'DJIA" description- 'DJIA Table" 
type="number" template="labels_only" position-" 1"> 
<item name="labeH" type-'var" value="Time"/> 
<item name- 'label2" type- Var" value- 'Value7> 
<item name="label3" type- Var" value-' Change7> 
<item name="label4" type="var" value="% Change"/> 
</construct> 



alert 




If an alert it set for the source/select defined, then the name is 
used to populate a set of variables. If the name is set to "alert", 
then the following variables will be defined (based off of how 
the alert was set up in the alerts configuration file): 

• alert_severity: The severity of the alert (0 through 3) 

• alert_msg: The alert message to display to the user 

• alertjiotes: Notes (not currently used) 

• alertjevel: The name of the alert level 

• alert_directional: Directional graphic suffix (e.g.: 
"red") 



lllill The prefix of a template variable to populate. 



The source file for the alerts. 
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select 


The data item in the alerts file to look for. 




<construct name- r DJIA" description- 'DJIA" type-'number" 
position= f T ? > 

<item name= M alert" type="alert" source="ALERTS" 

select="DJIA7> 

</constract> 







table 




Creates a table based on data elements supplied to it. 



The current implementation can only grab data from one 
source. Labels should also be moved down into options, like 
"legend" is for the "graph" type, 



The name of the table. The name is the name of the variable to 
be used in the template's loop. 



1 The source file for the table data. 



Options are specified as elements of a table. Each option 
defines one data source for the table. The option contains a 
name attribute that defines the variable to populate in the 
template's loop). The body of the option contains the select 
string into the table's data source. 



construct name="DJIA" description="DJIA Table" 
type-'number" template- 'detailtable" position- T ! > 
<item name="labell" type="var" value="Time7> 
<item name- label2" type="var" value="Value7> 
<item name="label3" type-"var" value="Change7> 
<item name="label4" type-Var" value="% Change7> 
<item name="table" type="table" source="DJIA"> 
<option name="datal ">current/timestamps/values</option> 
<option name= !, data2">current/values/values</option> 
<option name- f data3 ">difference/values/values</option> 
<optionname="data4 t '>percent/values/values</option> 
</item> 
</construct> 



graph 




Creates a graph based on data elements supplied to it. 



The current implementation can only grab data from one 

source. 



The name of the graph. The name is the name of the variable 
to be used in the template's loop. 



The source file for the graph data. 



An additional path into the source item's object tree. 

Options specify a number of arguments to the graph: 

* axisjlatanum: If an option name has the format: 
x datmum or y data^um (where num is a data plot 
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number, starting with "1"), then the body of the option 
contains the select string into the table's data source. 
If these types of options are not specified, then the 
graph's source is used as a single element to graph. 
The x-axis is the source's timestamps, and the y-axis is 
the source's values. 

labclnum: A label for the specified num data set. The 
default is to not have any labels on the graph, 
width: The width of the graph. The default is 180. 
height: The height of the graph. The default is 120. 
bgclr: The background color of the graph. The default 
is yellow (255,255,204). 



ggiliiillfl! 



mssm 



<construct name- 'HPLoad" description="HP Load Time" 

type- 'number" position- '13"> 
<item name- 'graph" type- f graph" source="servicemetrics M > 
<option name- r width n >500</option> 
<option name- ! height">200</option> 
<option name="bgclr M >#ffffff</option> 
<option name- ! x_datal ">sitel/values/values</option> 
<option name- 'yjiatal !! >sitel/timestamps/values</option> 
<option name="legendl">Site K/option> 
<option name="x_data2">site2/values/values</option> 
<option name="y_data2 H >site2/timestamps/values</option> 
<option name- , legend2">Site 2</option> 
</item> 

</construct> 
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Appendix E 

Dashboard Controller Variables 





An element's name is equal to "timestamp" or an element's 
select contains "timestamp". 


1 


Populates the following variables, with the element's name as 
the prefix: 

• prefix _sec: Seconds 

• prefix _min: Minutes 

• prefix Jiour: Hour in 24-hour clock 

• pre/?x_mday: Day of the month 

• prefixjoaon: Month number 

• prefix _year: 4-digit year 

• prefix _mon_nmr\Q : 3-character month name 

• prefix Jime: 12-hour time (e.g.: 1 :23 PM) 

• /?re/o; date: Date in MM/DD/YY format (e.g.: 1/13/01) 








iNotes 

^^^^^^^^^^^ 


A timestamp typically indicates a refresh time of the data 
object. It is supplied in the Unix time format (seconds). 





The "description" attribute is populated (which is required for 
all elements anyway). 


1 


lEffect 


Populates a "description" variable. 



Cause 


A "graph" item exists in the construct. 


Effect 

^^^^^^ 


HMI 


Ill 


A "graph" variable is populated with the URL to generate the 
graph image. 

A "graphjnap" variable is populated with the graph's 
imagemap. 

A "width" variable is populated with the graph's width. 
A "height" variable is populated with the graph's height. 


jgjjj 




SI 

8 



Cause 




The "refresh" or "data refresh" attributes are populated. 






^ : :; : :;t;: 


Populates a "refresh" variable that contains the refresh rate in 
the following format: 

• 10 s (10 seconds) 

• 10 m (10 minutes) 

• 10 h (10 hours) 

• 10 d (10 days) 

The controller figures out which format to use depending on 
how large the refresh number is. 




1:1: . 

wm 


■ 

iiiiib 


mmm 






potes 


This currently doesn't deal with fractions (i.e.: 1.6 h is seen as 
lh). 
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Cause 


None 






Bin 


A "script" variable is populated with the URL that generated 
the current construct. This doesn't have much use in the 
templates, but it's used internally in the controller. 




Cause 




None 


Effect 


A "dashboardtop" variable is populated with the URL that 
generates the top-level of the dashboard. Useful for linking a 
"home" button. 








onSelectScreen attribute is set in the construct. 


Effect 




t 


One of "onSelectScreenFull", "onSelectScreenFramed" ? or 
"onSelectScreenPopup" variables is set to 1, depending on the 
value of onSelectScreen. 



Cause 




onSelect attribute is set in the construct. 






— TT-"-— 

l|pIlH 


"drilldown", "drilldownframed", "drilldowntable" variables 
are populated with the URL to the selected section (current 
format, framed format and table format, respectively). The 
URLs are auto-generated based on the onSelect attribute in this 
item's construct. 


m 


11 


HB 




111 



Cause 


BUG 


Effect 


An "onReport" attribute should be recognized inside the 
construct, but currently it's not. Instead, we set it using a 
"var" type, which works out just fine. 






unit attribute is populated within an item. 




An itemname unit variable is populated with its value. 


Notes ' ; 


This could probably be moved into an item of type "var". 






Effect 


prefix attribute is populated within an item. 

An itemname prefix variable is populated with its value. 




This could probably be moved into an item of type "var". 
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An item named "direction" exists. 




If the value of "direction" is: 

• positive: Variable "directionup" is set to 1 

• zero: Variable "directionneutral" is set to 1 

• negative: Variable "directiondown" is set to 1 




This is useful for determining if an up arrow or a down arrow 
should be displayed on the indicator. A direction item is 
typically the indicator's rate: 
<item name-'direction" source- 'sysload" 
select- T cpu/rate7> 



Cause 


An item named "history" exists. 


llf§ ct 


The following variables are set: 

• "high": Highest value in the history 

• "low": Lowest value in the history 


^^^^^^^^^^^^^^^^^^^^^ 



Cause 


An attribute named "helptext" exists. 




A "helptext" variable is populated and a "helpurl" variable is 
populated with the URL to a help popup window 





Cause 


An "alert" type exists within the construct. 


IHeet 


See the "alert" type above. 
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Appendix F 

Dashboard Controller Templates 



Number 





^ Displays a small, framed primary indicator with a graph 
f Deneatn n oi tne muicator s ni story 




, lnis snouia reany oe renamed to summary instead oi 

IlUlllUCl . 


Primary 


::• nimiiaDie/numDer.xmpi 






htmltable/visionport.css 

: htmltable/visionport.js 

r; nimiiduie/ summary tiucDdr.impi 
htmltable/summary_numbdisp.tmpl 
htmltable/ summary_asofdate.tmpl 
htmltable/summary graph. tmpl 


Variables Use 






Titlebar 






Used as the title for the indicator 


drUtdown 
table 


■ 

IK 

lip 


? If populated, a detail icon will be created with a link to the 
URL contained in drilldowntable. Note that this variable is 
automatically created by the controller if onSelect is 

I populated. 


drilldown 

a 


Ills! 


1 If populated, and onselectscreenframe is also populated, a 
! detail icon will be created with a link to the URL contained 
j in drilldownframed. Note that this variable is automatically 
I created by the controller if onSelect is populated. 


ScreenFull 


■ 

lillllSs 
BH|| 

■i 


I If populated, and drilldownframed is populated, a detail icon 
f will be created with a link to the URL contamed m 
| drilldownframed with target="_top". Note that this variable 
| is automatically created by the controller if onSelectScreen is 
j populated. 




1 If populated, and drilldownframed is populated, a detail icon 

will fr&ai'C*/^ 1*71+11 ci 1inl^" "r<r\ f-li TTT?T r»r\tif oi-n Arl i-r» 

win uc t/icdicu wiLii d. in iK iu tne uivl^ cuniameu. m 
drilldownframed, to appear in the existing frame. Note that 
this variable is automatically created by the controller if 
onSelectScreen is populated. 




If populated, a report icon link will be created to the URL 
contamed in reporturl. 


ScreenFull 


If reporturl is populated, adds target="_top" to the link. By 
default, a reporturl is displayed in a popup window. 




lisiilip*' 


If reporturl is populated the reporturl will be displayed in 
the current frame. By default, a reporturl is displayed in a 
popup window. 
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f helpu 




\ If populated, a help icon link will be created to the URL 
\ contained in helpurL Note that this variable is created 
\ automatically by the controller if helptext is populated. 


Numbdisp 










The primary indicator number, displayed in bold, as 
populated by an item named "current". 




If a unit is specified within the "current" item, it will be 
placed directly after the primary indicator (e.g.: 123 page 
views). 




direction 


One of directionup, directiondown, or directionneutral is set 
by the controller depending on the value specified by the 
difference item. 


up 




direction 


See directionup. 




^ ^^^^^^^^^^^^ 
neutral 


See directionup. 






Br 


alert ^directional is set if an alert is found for this indicator. 
The directional is used as a suffix for the up/down image. 
For example, if alert _directional is set to "red", then 
"upred.gif" or "downred.gif will be leaded as the up/down 
image. 




severi 




alert _severity is set if an alert is found for this indicator. The 
severity is used as a suffix for the alert icon. For example, if 
alertjseverity is set to "2", then "alertl.gif ' is used for the 
alert image. If alert _severity is 0, then no alert image is 
displayed, alertjseverity is also displayed when the user 
mouses over the alert icon. 


m 

^^^^^^^ 


Ipll 

£&§™ 


he 

^^^^ 

!;|I1|pI 
■gill) 


alert_msg 


■Hi 


alert msg is set if an alert is found for this indicator. The 
msg is displayed along with the alert's severity when the 
user mouses over the alert icon. 




; 

: v. 


direction 


181 

IIP 


The current "direction" of the indictor, as populated by an 
item named "direction". This is typically the current rate of 
change. 




direction 
unit * 




If a unit is specified within the "direction" item, it will be 
placed directly after the direction (e.g.: -3.4%). 








nmesramp 


• 

US 

Nil 


If an item named "timestamp" is populated, the controller 
will automatically populate these timestamp_* variables. 
These variables are used to tell the end-user when the last 
time the data was updated. 


timestamp 




See timestamp mon name. 






timestamp 
year 




See timestamp jnonjiame. 




See timestamp monjiame. 
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If the construct contains a datajrefresh attribute, or the 
construct contains a screen ^refresh item, then this variable 
will automatically be populated by the controller. This 
variable is used to tell the user how frequently the data is 
updated. 



graph 



If a "graph" item is contained in the construct, then the 
controller will automatically populate this variable. The 
variable contains a link to the URL that will display the 
graph. 



If this variable is populated (see the "Titlebar" section), then 
the graph is also linked to this URL. 



The description is used to populate the ALT tag of the graph. 



^^^^^^^^^^^^^^^^^^^^^^ 



■pngi 



mm 
mMaMsmmmM 



<construct name- ! DJIAcurrent" description- r DJIA" 
type="number" position="2" onselect- 'DJIA_graph"> 

<item name- 'reporturl" type- Var" 
value="http://quote.yahoo.com/q?s= A dji&d=b t V> 

<item name="alert" type-"alert" source^" ALERTS" 
select="DJIA7> 

<item name- 'alertjper" type- 'alert" source=" ALERTS" 
select="DJIA_percent7> 

<item name- 'graph" type- 'graph" source="DJIA rr 
select= ,, current t V> 

<item name^'current" source- ! DJIA" 
select="current/value'7> 

<item name-'history" source-'DJIA" 
select="current/values/values"/> 

<item name- 'direction" source-'DJIA" 
select="difference/value"/> 

<item name-'percent" source-'DJIA" 
select- f percent/value7> 

<item name="timestamp" source-'DJIA" 
select="current/timestamp"/> 

<item name- f screen_refresh" source="DJIA" 
select="current/refresh"/> 

<attr name- 'helptext"> 

</attr> 
</construct> 
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IppllBIllMlI 




9,842.33 + £ 7 

As of Mar 30 2001, lOiOlam: $ 10 m 

3944 ^_ „ — , 

i 9891^ _™ .. , ...... ,J 

!^ 38 b^ : X: ^-^r -^H 




9786 £ - ^ J 

9733j — - - ■ - i 

96SiL — „ \ 



Su mmarystats 





Displays a small, framed primary indicator with a set of 
supporting statistics beneath it. 






htmltable/summary_stats.tmpl 


Temj 
Inclu 


Mates 
ded 


htmltable/visionport.css 
htmltable/visionportj s 
htmltable/summary_titlebar.tmpl 
htmltable/ summary_statupper. tmpl 
htmltable/ summary_asofdate.tmpl 
htmltable/summary statslower.tmpl 




TariaSles Used 




Titlebar 


See the "Titlebar" section under the Number template. 










The primary indicator number, displayed in bold, as populated 
by an item named "vail". 


, 


If a unit is specified within the "vail" item, it will be placed 
directly after the primary indicator (e.g.: 123 page views). 


g valljprefix 


If a prefix is specified within the "vail" item, it will be placed 
directly before the primary indicator (e.g.: Page Views: 123). 




The rate of change for the primary indicator, as populated by 
an item named "vallrate". 


unit 


If a unit is specified within the "vallrate" item, it will be 
placed directly after the rate (e.g.: -1.23%). 


Asofdate 


See the "Asofdate" section under the Number template. 


statelower 




m •-• ■ 


A statistic, as populated by an item named "vabt" where x is a 
number from 2 to 5. 




If a unit is specified within the "vabt" item, it will be placed 
directly after the primary indicator (e.g.: 123 page views). 


val 






If a prefix is specified within the "valx" item, it will be placed 
directly before the primary indicator (e.g.: Page Views: 123). 




xrate 




The rate of change for the primary indicator, as populated by 
an item named "valerate". 




If a unit is specified within the "valerate" item, it will be 
placed directly after the rate (e.g.: -1.23%). 
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illlli 



} 



<construct name- r SiteStats_yesterday" 
description="Yesterday" type- 'summary_stats" 
data_refresh="86400" position="9"> 

<item name-'reporturl" type =l, var" value- Vcgi- 
bin/webtrends_redirect/5/rV> 

<item name- Vail" source- ! historical_stats" 
select="all/yesterday/pageviews/value" unit= l, pv"/> 

<item name="timestamp" source- ! historical_stats" 
select="all/yesterday/pageviews/timestamp"/> 

<item name- 'screen jrefresh" source="historical_stats" 
select="all/yesterday/pageviews/refresh"/> 

<item name- Val2" source- 'historical_stats" 
select="all/yesterday/visits/value" unit- 'visits7> 

<item name- 'val3 M source- 'historicalstats" 
select : = M all/yesterday/unique_visitors/value M unit- 'unique 
visitors'7> 

<item name-Val4" source- 'historicalstats" 
select="all/yesterday/firsttime_visits/value" unit="new 
visitors ! 7> 

<item name- Val5" source- ! historical_stats" 
select="all/yesterday/dwell/value" unit="dwell time" 
format- r elapsed7> 
</construct> 



2,012,152 pv 

As of Mar 29 2001, 12:00am: $ld 

351,270 visits 
274,095 unique visitors 
52,853 new visitors 
5; 56 dwell time 



Co ntrol, Control subpage 




Displays a small, framed "Control Panel". The only difference 
between Control and Control_subpage is the inclusion of a 
"back" button on the subpage version. 



htmltable/control.tmpl 
htmltable/controlsubpage.tmpl 



htmltable/visionport.css 
htmltable/visionport.j s 



Link to the "top level" of the dashboard. This variable is 
automatically populated by the controller. 
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If populated, the weblog variable will link the user to a 3 rd 
party product for viewing their web logs. 



Description shown to the user if weblog is populated. 



Second weblog, typically populated if the user has two weblog 
profiles to view. 



Description for the second weblog. 



mm 



Sill 




itflll 


















ill 












1311 




38 


an 


1KH 






SSI 


iiiiiiiiiiiiiiii!^ 





<construct name-'Control" description- 'Control" 
type- 'control" position= n r'> 

<item name= ,r weblog M type- Var" 
value="http://visionport.xor.com/webtrends/demo/ r V> 

<item name- r weblog_desc" type- T var" value- 'Site Log 
Reports7> 
</construct> 



» Site Loa Reports . . 'mM 



T'i jB ma II Dashboard 

» Exit J ^ -I V : - ^ ■ : ■ : t 11 




Cli entlogo 




Displays a small, framed logo. 



htmltable/clientlogo.tmpl 




URL to the image to display. 



width 



Width of the image. 



Height of the image. 



ALT text for the image. 



Link to the customer's web site 



XML 




<construct name- 'Logo" description- 'Logo" 

type="clientlogo" position- f 1 6 !! > 
<item name- 'image" type-'var" 

value="http://www.client.com/images/logo.gif7> 
<item name-'width" type="var" value- '100"/> 
<item name="height" type="var" value="50"/> 
<item name="alt" type="var" value=" Client Site7> 
<item name- 'url" type- Var" 

value= n http://www.client.com n /> 

</constract> 
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Blank 



ilaiiiripjiift -ai 


Displays only a title bar. This is used for displaying an 
indicator that only has links to a detail and/or report icon. 
Useful for displaying a "More Indicators" cell. 




htmltable/blank.tmpl 


Included 




htmltable/visionport.css 
htmltable/visionport j s 
htmltable/summary titlebar.tmpl 








See the "Titlebar" section under the Number template. 


XML 


!ll|- ;r !:-:I 
li|;l;S;:! :j :: 


<construct name- 'next" description- 'More SysLoad ->" 
type= M blank" position="2" onselectscreen="full" 
onselect= M SysLoad__graph2 "> 
</construct> 


Screenshot 

Illli - 


fl!|l3l|i 









De tailgraph 



Description 


Displays a larger version of a "Number" template. The graph 
is significantly larger and contains labels on the x- and y-axis. 
High and lows from the graph are also displayed. 


Primary 


llf 
Hi 


htmltable/detail_graph.tmpl 


Temp 
Inclu 


dates 
ded 


■ 

IIS 

111 
il 

11 


htmltable/visionport.css 

htmltable/visionport j s 

htmltable/detail_titlebar.tmpl 

htmltable/detail_numbdisp.tmpl 

htmltable/detail_graph_toggle.tmpl 

htmltable/detailgraphbody.tmpl 

htmltable/detail footer.tmpl 








Used for the title of the page. 




B 


See the "Numbdisp" section under the Number template. The 
following variables are also used: 


■ 


^^^^^^^^ 


ft 


If the construct contains a data_refresh attribute, or the 
construct contains a screenjrefresh item, then this variable 
will automatically be populated by the controller. This 
variable is used to tell the user how frequently the data is 
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updated. 



high 



The high is automatically populated if the construct has a 
"history" item defined. 



The low is automatically populated if the construct has a 
"history" item defined. 



jgjjgle 



table 



Used to toggle between a graph and a table. The onSelect 
should be set to the table version of this graph. 



See the "graph" section of the Number template. Also uses the 
timestamp variables starttime and enddtime. 



Ster 



No variables; just an HTML footer with XOR's copyright. 




"" 11 



<section name- 'NASD AQ_graph" description- 'NASDAQ 
Detail" template="tsn"> 

<construct name="NASDAQ" description="NASDAQ 
Detail" type- 'number" position- 1 1" 
onselect="NASDAQ_chart" template="detail_graph"> 

<item name- ! graph" type- 'graph" source- 'NASDAQ" 
select="current"> 

<option name- f width">500</option> 
<option name="height">200</option> 
<option name="bgclr">#ffffff</option> 
</item> 

_ <item name="current" source="NASDAQ" 
select- r current/value7> 

<item name="history" source =1, NASDAQ" 
select="current/values/values"/> 

<item name="direction" source- 'NASDAQ" 
select- ! difference/value'V> 

<item name- 'percent" source- 'NASDAQ" 
select- 'percent/value"/> 

<item name="starttime" source- 'NASDAQ" 
select="current/timestamps/values , '/> 

<item name- 'endtime" source="NASDAQ" 
select="current/timestamp7> 

<item name- 'timestamp" source="NASDAQ" 
select^"cwrent/timestamp7> 

<item name="screen_refresh" source- 'NASDAQ" 
select="current/refresh"/> 
</construct> 
</section> 
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Detail table 





Displays a table of the raw data for a set of information. This 
is typically linked with a detail graph template. 


Template 


htmltable/detail table.tmpl 


Templates 

- 


htmltable/visionport. ess 
htmltable/visionport.j s 
htmltable/detail_titlebar.tmpl 
htmltable/detail_nunibdisp.tmpl 
htmltable/detail_table_toggle.tmpl 
htmltable/ detail __table_body.tmpl 
htmltable/detail footer.tmpl 












See the "Titlebar" section under the Detail graph template. 




See the "Numbdisp" section under the Detail graph template. 




See the "Graph_toggle" section under the Detail_graph 
template. 








Labels for the chart, where x is 1 through 5 




Data items that are looped over to populate the chart, x is a 
number 1 through 5. 




No variables; just an HTML footer with XOR's copyright. 


XML 




<section name="NASDAQ_chart M description="NASDAQ 
Chart" template="tsn"> 
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^^^^^^^^^^^^^ 



^^^^^^^^^^^^^ 



mm 



(W: : 'fc(jii^B^SlilliiK ;:;: S 




<construct name="NASDAQ" description-"NASDAQ 
Chart" type="number" template="detail_table" positional" 
onselect="NASDACLgraph"> 
<item name- labell" type- Var" value- Time7> 
<item name="label2" type="var" value="Value7> 
<item name= M label3" type="var" value="Change7> 
<item name="label4" type="var" value="% Change7> 
<item name-"table M type="table" source="NASDAQ"> 
<option 

name="datal">current/timestamps/values</option> 

<option name="data2">current/values/values</option> 
<option name- ? data3 ">difference/values/values</option> 
<option name= M data4">percent/values/values</option> 
</item> 

<item name- Current" source-'NASDAQ" 
select="current/value"/> 

<item name- 'history" source- 'NASDAQ" 
select="current/values/values"/> 

<item name- 'direction" source-'NASDAQ" 
select= H difference/value"/> 

<item name="percent" source-'NASDAQ" 
select- 'percent/value7> 

<item name="starttime ,! source="NASDAQ" 
select="current/timestamps/values ? 7> 

<item name- 'endtime" source-'NASDAQ" 
select-'current/timestamp"^ 

<item name- 'timestamp" source- 'NASDAQ" 
select="current/timestamp"/> 

<item name="screen_refresh" source-'NASDAQ" 
select- 'current/refresh7> 
</construct> 
</section> 
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1 



^^^^^^^ 



B3h 



^NASDAQ Chart Indicator - Netscape: 



lllllpt View So Communicator Help 



1,828.22 +7X5 

mSfBW^Smai:\ SIS 

Timeperiocl High: 1,854 



graph | Table 



3/30/01 1:51pm 1,828.22 
3/30/01 1:41pm 1,842.96 
3/30/01 1:31pm 1,330.05 
3/30/01 1:21pm 1,837.08 
3/30/01 lillpm 1,841.33 +20.81 
3/30/01 t:01pm 1,341.56 +20.98 
3/30/01 12:51pm 1,846.27 
3/30/01 12i41pm 1,354 
3/30/01 12:3ipm 1,346.44 +25.87 
3/30/01 12:21pm 1,846,04 +25.47 
3/30/01 12: 1 lpm 1,840.20 +19,63 
3/30/01 12:01pm 1,825.53 +4.96 
3.00ft LUiSlam 1,625,53 +4,56 



+7.65 
+22.39 

+9.48 
+16.51 



+25.70 
+33.43 



+0.42 
+ 123 
+0.52 
+0.91 
+1.14 
+1.15 
+1.41 
+1.84 
+1.42 
+ 1.40 
+ 1.08 
+0.27 
+027 



Detail stats 



Displays a larger version of a 4< Number" template. The graph 
is significantly larger and contains labels on the x- and y-axis. 
High and lows from the graph are also displayed. 




htmltable/detailstats.tmpl 



htmltable/visionport.css 
htmltable/visionportj s 
htmltable/detail_titlebar.tmpl 
htmltable/detailjiumbdisp.tmpl 
htmltable/ detail_stats_body.tmpl 
htmltable/detail footer.tmpl 



See the "Titlebar" section under the Detail graph template. 




See the "Numbdisp" section under the Detail graph template. 



Labels for the chart, where x is 1 through 5 




Data items that are used to populate the table of statistics, x 
and >> range from 1 to 5. There's probably a much better way 
to do this than the way it's currently coded. . . 



No variables; just an HTML footer with XOR's copyright. 



<construct name= !f RegUsersDetair description- 'Registration 
Detail" type= f 'number" template="detail_stats" positioner 
data refresh="3600"> 
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■■IP ; 



IPS 



m ^ 



IB 



"jnr£iiyiiii;;iiiiii!:;;-;^J^ 



I 



<item name="labell" type- Var" value- 'User-Type7> 
<item name- 'label2" type- Var" value="Total7> 
<item name- 'label3" type- Var" value- ' Yesterday' 7> 
<item name- 'label4" type- Var" value- Today7> 

<item name="datal_l M type="var" value="AU:7> 

<item name="datal_2" source- 'regjhistory" 
select="appusers/all/All/value"/> 

<item name="datal_3" source="reg__history" 
select="appusers/yesterday/All/value7> 

<item name="datal_4" source- 'regJ;oday M 
select- , appusers/today/All/value7> 

<item name- 'data2 type- Var" value- 'Custom HP:7> 

<item name- f data2_2" source- Yeg history" 
select- r appusers/all/l 6/value"/> 

<item name- f data2J3" source- 'reg_history" 
select="appusers/yesterday/16/value7> 

<item name- f data2_4" source- r regjx>day" 
select- f appusers/today/16/value7> 

<item name="data3_r type- Var" value-Tantasy BB:7> 

<item name- ! data3_2" source- 'regjhistory" 
select="appusers/all/23/value7> 

<item name- , data3_3" source="reg_history" 
select="appusers/yesterday/23/value7> 

<item name- *data3_4" source="reg_today" 
select- f appusers/today/23/value7> 

</construct> 
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^Registration Detail Indicator - Netscape 



mm 



m 2000 ?.QR Inc., ASi Rights Reserved 



ose window 





255,219 users 




' : * : "- User-Type 
All: 


255,219 


^stcHtay!- 
1,174 


today 

543 


Custom HP: 


125,704 


107 


M 


Fantasy BB: 


8,942 


433 


221 


Magazine Subs Total: 


3,147 


32 


15 


Magazine Subs Charged: 


345 


8 


4 


Magaane Subs Billed: 


5,046 


26 


14 * 


Giliete: 


25,984 


273 


106 


Trophy Game: 


342 


0 


0 


Peoplebnk: 


9,741 


261 


106 


Fantasy FB: 


24,336 


9 


2 


Draft Kits Total: 


13,067 


438 


283 


Draft Kits (Free): 


10,053 


286 


155 


Draft Kits (Bought): 


3,014 


202 


129 


March Madness: 


71,997 


16 


14 



Sh owhelp 



Tk—l^ *y 

— J. 




Template used for the popup help window. 



htmltableManlctmpl 



htmltable/visionport.css 
htmltable/detail_titlebar.tmpl 
htmltable/detail footer.tmpl 




Help text, as defined a construct' 's helptext attribute. 



See the "Titlebar" section under the Detail Graphtemplate. 



See the "Footer" section under the Detail Graph template. 



N/A 
N/A 



Small Dashboard 





A collection of the summary_* templates that are used to 
display a smaller version of the dashboard. 


Primary 






htmltable/small/*.tmpl 




See the normal templates for the variables. There is no 
additional work required in the controller configuration file to 
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use the small templates. The dashboard has a "switch", 
controlled by the subtemplate QUERYJSTRING variable on 
the URL. When the controller sees this set, it first looks in the 
named subtemplate directory for the template first, and then 
defaults to the normal template directory. 


XML 


N/A 


lilrl&shot 


N/A 
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Appendix G 

Dashboard Indicator Details 



Indicator 




Data Details 



The Dow Jones Industrial Average, NASDAQ index and 
Standard and Poors 500 index. This information is gathered 
from Yahoo Financial by "screen scraping" the data from 
their HTML pages. When XOR has a client that wants this 
information a stock subscription service will be used. 



This information is gathered every 10 minutes from the 
client's different web servers. A process runs on each server 
and constantly collects information about visits, hits, page 
views and content groups being served. Note that this 
currently only runs on Unix systems. This indicator also 
displays the number of new registrations received for the 
current day and the number of visits from users that have 
registered previously on the site. Selecting the "detail" icon 
displays a breakdown of statistics for each server. 



The client that this data is taken from displays banner ads on 



their site using a 3 r party ad-serving program called 
RealMedia OpenAdstream. XOR developed a Dashboard 
agent that parses the log files of the ad-server and reports on 
each ad "position" being served. Selecting the "detail" icon 
displays a breakdown of all the different ad positions. 



Today's 




The revenue number is a combination of dollars per visitor 
(this is how the client estimates their advertisement and 
sponsorship revenue) and actual subscription services sold 
on the site. Subscription information is extracted from the 
client's Informix database. 



These statistics are gathered either from XOR's proprietary 
log analysis tool (all clients hosted by XOR receive a 
monthly report generated by this tool) or from another 3 rd 
party log analysis package, such as CommerceTrends. In 
this case, CommerceTrends was used. Selecting the "report" 
icon brings the user into the CommerceTrends report for the 
selected date. 
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HP Loac 


I Time 


XOR has a partnership with a Service Metrics, a company 
that measures download times for a given URL from 
multiple points around the Internet. This gives the client a 
good idea about an average user's "download time 
experience". The graph displays two different views of this 
client's site: downloading their homepage with ads and 
without ads. This was done to help pinpoint problems with a 
3 rd party ad service (24x7 Media) that caused the client's 
homepage to consistently load at least two seconds slower 
when using 24x7 Media's service. The third line on the 
graph is an "Internet Index" that Service Metrics provides. 
This is the average download time of 100 large Internet sites. 
There's another index, the "eCommerce Index" that can also 
be displayed with this graph. Service Metrics is a standard 
option of the VisionPort offering to which a client can 
subscribe. 












^^^^^^^^^ 








Average 


^oad 


This measures the average system load across the client's 
four main servers. Typically, the higher the load, the busier 
the machine. This information is gathered on-demand from 
each machine's operating system statistics. Selecting the 
"detail" icon displays system details about each individual 
machine. 


sSystem I 


^^^^^^^^^^^^^^^ 


II 




& 


ed Users 


This particular client has a registration system on their site. 
The indicator displayslhe number of users that have 
registered for various servicesrThe main Dashboard screen 
displays the services that the client is most interested in 
watching. This indicator is changed at the client's request to 
display other registration types. Selecting the "detail" icon 
displays a breakdown of all types of registered users. 


■■■ 
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